home *** CD-ROM | disk | FTP | other *** search
/ MIDICraft's MIDINET CD-ROM / MIDICraft's MIDINET CD-ROM.iso / DOSUTILS / FINDI3.DOC < prev    next >
Text File  |  1997-01-12  |  5KB  |  158 lines
  1.         ******************************
  2.               FINDI3 v1.1 
  3.                  (DOS)
  4.     
  5.             search names in KORG files
  6.               by Guenter Nagler 
  7.                 1996 
  8.           (gnagler@ihm.tu-graz.ac.at)
  9.         ******************************
  10.  
  11. [1] BACKGROUND
  12. KORG i2/i3 keyboards store can their data on 720KB floppy disks in
  13. files with extensions 
  14.    *.pcg  program data (64 programs + 2 drum kits)
  15.    *.sty  style data  (4 styles)
  16.    *.arr  arrangement data (64 programs)
  17.    *.sng  song data (10 songs)
  18.    *.bsq  backing sequence data (10 backing sequences)
  19.  
  20. All stored entries have a name (10 characters).
  21. When you have a lot of such files finding certain arrangements
  22. will be not easy because KORG shows the names only after loading
  23. which takes long time.
  24. This utility should help me find names in my Korg files.
  25.  
  26. [2] FILES DESCRIPTION
  27.  
  28. FINDI3.EXE..........MSDOS executable for korg i3 name search
  29. FINDI3.DOC..........this file, showing usage of FINDI3.EXE
  30. only FINDI3.EXE is required to run program 
  31.  
  32. [3] COPYRIGHT
  33.  
  34. FINDI3 (c) 1996 was created by Guenter Nagler.
  35.  
  36. FINDI3 is free and may be used as you wish with this one exception:
  37.  
  38.     You may NOT charge any fee or derive any profit for distribution
  39.     of FINDI3.  Thus, you may NOT sell or bundle FINDI3 with any 
  40.     product in a retail environment (shareware disk distribution, CD-ROM,
  41.     etc.) without permission of the author.
  42.  
  43. You may give FINDI3 to your friends, upload it to a BBS, or ftp it to
  44. another internet site, as long as you don't charge anything for it.
  45.  
  46. [4] DISCLAIMER
  47.  
  48. FINDI3 was designed to search names in standard KORG i3 files.
  49.  
  50. Use FINDI3 at your own risk.  Anything you do with FINDI3 is your
  51. responsibility, and not the author's.  Any damage caused to any person,
  52. computer, software, hardware, company, or business by running FINDI3 
  53. is your responsibility, and the author will not be liable.
  54.  
  55. If you don't understand these terms, or are not sure of something, or
  56. are afraid something bad might come of using FINDI3, don't  use  it!
  57. You are here forewarned.
  58.  
  59. [5] INSTALLATION 
  60.  
  61.   Simply copy FINDI3.EXE in a directory that is in your path.
  62.   When you start the program without arguments
  63.  
  64.   C:\> FINDI3 -h
  65.  
  66.   you should get the usage text (see next section)
  67.  
  68. [6] USAGE
  69.  
  70. findi3 searches names in korg files
  71. usage: findi3 [-h] [-p] [-m filemask] name ...
  72. -h or -?    show this usage information
  73. -p        pause screen after each page
  74. -m filemask    search only in files matching filemask (default: *.*)
  75. name can contain wildcards (*,?)
  76.  
  77. name is a word or simple regular expression (*, ?).
  78. The search will automatically do substring search (match name if it contains the word).
  79. It is allowed to specify more than one name. FINDI3 searches with logic-OR
  80. (find all entries that match any of the names)
  81.  
  82. wildcards for search:
  83. *    matches 0 or more characters
  84. ?    matches exactly one character
  85.  
  86. search is caseinsensitive (upper letters are treated as lower letters).
  87.  
  88. If no name is specified then * is assumed.
  89.  
  90. [7] OUTPUT MESSAGES
  91.  
  92. If no korg files are available or no file matches the filemask specified
  93. with option -m then FINDi3 writes:
  94. No KORG files found
  95.  
  96. When no name is found in any of the Korg files then
  97. FINDI3 stops with message:
  98. No matching names found.
  99.  
  100. Otherwise FINDI3 writes following lines:
  101. Name          Loc    Filename
  102. --------      ---    --------
  103.  
  104. Loc has different format for the file types:
  105. PCG ....... D11-D88 (bank D on KORG i2/i3 contains user programs)
  106. STY ....... U1-U4  (4 user styles on KORG i2/i3)
  107. ARR ....... A11-A88
  108. SNG ....... S0-S9
  109. BSQ ....... BSQ0-BSQ9
  110.  
  111. Warning: FINDI3 ignores all files that are not KORG type 9 (i2/i3)
  112. and empty *.SNG and *.BSQ files.
  113.  
  114.  
  115. [8] SUGGESTIONS / COMMENTS / BUG REPORTS / QUESTIONS
  116.  
  117.          WWW:    http://hgiicm.tu-graz.ac.at/Cpub
  118.           contains all my dos/unix midi programs
  119.          EMAIL:  gnagler@ihm.tu-graz.ac.at
  120.  
  121. [9] EXAMPLES
  122.  
  123. get a listing of all names in all korg files in current directory
  124. C:\> findi3 > names.txt
  125.  
  126. The listing will be written to the file names.txt
  127.  
  128. find all flutes
  129. C:> findi3 -p *fl*t* 
  130. Name          Loc    Filename
  131. --------      ---    --------
  132. FluteClar     D71    KORG.PCG
  133. Air Flute     D44    HIGH.PCG
  134.  
  135. option -p would stop the listing if the current page is full
  136. the ? would allow variable spelling of flute in different languages
  137.  (e.g. flute, floete, ...)
  138.  
  139. find all names beginning with character a in files high.*
  140.  
  141. C:\> findi3 -m high.* a
  142. Name          Loc    Filename
  143. --------      ---    --------
  144. AOR Rock      A27    HIGH.ARR
  145. AfterHours    A62    HIGH.ARR
  146. AfricanJam    D37    HIGH.PCG
  147. AltoBreath    D41    HIGH.PCG
  148. Air Flute     D44    HIGH.PCG
  149. AnaSyn        D53    HIGH.PCG
  150. Analogist     D56    HIGH.PCG
  151. Aoud          D64    HIGH.PCG
  152.  
  153. [10] CHANGES
  154. v1.0 to v1.1:
  155.   * not restrict to files beginning with "KORG9" id (i2/i3)
  156.   * ignore default names for usual empty entries
  157.  
  158.